home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 090 / sbreak.arc / SBREAK.DOC next >
Text File  |  1986-08-13  |  6KB  |  119 lines
  1.                               SUPERBREAKER  v1.02 
  2.                                       by
  3.                                Thomas A. Lundin
  4.                             Graphics Unlimited Inc.
  5.                            3000 Second Street North
  6.                             Minneapolis, MN  55411
  7.                                 (612) 588-7571
  8.  
  9.  
  10. Superbreaker is a powerful file splitting program. ASCII text files can be 
  11. split in the following ways: 
  12.  
  13.      o    According to size
  14.                Optionally to the next CR/LF line boundary
  15.      o    According to an ASCII or hex match string
  16.                Matching string can be output before the split 
  17.                Matching string can be output after the split    
  18.                Matching string can be ignored at the split 
  19.      o    According to a line count
  20.                Optionally converting 8-bit characters to 7-bit
  21.  
  22.  
  23.                                    OPERATION
  24.  
  25. The program is invoked as follows:
  26.  
  27. C>SBREAK FILENAME
  28.    or
  29. C>SBREAK @FILENAME
  30.  
  31. where FILENAME is the large file to be broken up. Multiple files can be 
  32. processed from one command line invocation by redirecting a DIR to a file 
  33. (e.g., dir *.dat >dirlist); if this list file is preceded by a commercial "at" 
  34. sign when the program is invoked, each file in the list will be processed in 
  35. turn.
  36.  
  37.      The names of the split files consist of the main file name and a numeric 
  38. extension between 001 and 999. For example, the file DATA.TXT would be split 
  39. into DATA.001, DATA.002, etc. (It is vital that the input file you wish to 
  40. split does not contain a three-digit file extension.) As split files are 
  41. created, the names are displayed on the screen. 
  42.  
  43.      The program will prompt you for your choice of split method. You should 
  44. respond with S for size, M for match, or L for line count.
  45.  
  46.                                  SIZE BREAKING
  47.  
  48. If you choose this method, you will be asked to enter the size you wish the 
  49. split files to take. The value may contain commas or any other character, but 
  50. only the numeric digits will be recognized (i.e., 500.00 is the same as 
  51. 50000). You will next be asked whether you wish the file split to occur at a 
  52. carriage return-line feed boundary. If you answer 'N', your split files will 
  53. be exactly as long as your size value, regardless of where the break occurs. 
  54. If you answer 'Y', your files may be somewhat larger than your size value, 
  55. depending upon where the next CR/LF combination is encountered in the data 
  56. stream.
  57.  
  58.      Breaking by size is the fastest method.
  59.  
  60.  
  61.                                 MATCH BREAKING
  62.  
  63. You will be asked to enter the string that will trigger a file break. The 
  64. string can consist of ASCII characters or hex values, which can be 
  65. intermingled. A hex value is entered as a backslash followed by two hex digits 
  66. in the range 0-9 and A-F (e.g., \0d). Up to 80 characters may be entered in a 
  67. break string, but remember the use of hex values takes up 3 positions. ASCII 
  68. character matches are case sensitive.
  69.  
  70.      You have the ability to control what is done with the break string once a 
  71. match has occurred. You may choose to:
  72.  
  73.      1.   Place the match break at the end of the file BEFORE a split is made;
  74.      2.   Place the match break at the beginning of the file AFTER a split is 
  75.           made;
  76.      3.   Make a split and throw away the match break.
  77.  
  78.  
  79.                               LINE COUNT BREAKING
  80.  
  81. With this option, you will be asked to enter a value for the number of lines 
  82. you wish each split file to contain. A "line" is terminated by a carriage 
  83. return. Line feeds are IGNORED on input, but are automatically placed after 
  84. each line on output. This will have an impact only if the file you are 
  85. breaking by line contains line feeds not paired with a carriage return.
  86.  
  87.      The next prompt will ask you if you want to convert 8-bit ASCII 
  88. characters to 7-bit ASCII. For standard ASCII input files, answering either 
  89. 'Y' or 'N' will have no effect on the output. Some programs (such as Wordstar 
  90. document mode) use 8-bit characters in place of the standard CR/LF combination 
  91. to isolate lines. In these instances, answering 'Y' will do two things: first, 
  92. it will guarantee that the line count will be implemented correctly; second, 
  93. the split files will be plain ASCII text files with the 8th bit removed from 
  94. the characters. Should you answer 'N' to these types of files, the line count 
  95. will be implemented only at each instance of a true ASCII carriage return (hex 
  96. 0D). In Wordstar, a true carriage return occurs only at the end of a 
  97. paragraph; hence, a "line" is equal to a full paragraph in Wordstar document 
  98. mode. Be aware of these distinctions. Superbreaker will accept a single "line" 
  99. up to 24,000 characters long. 
  100.  
  101.      Breaking by line count is the slowest method.
  102.  
  103.  
  104.                                      NOTES
  105.  
  106. This program is distributed as SHAREWARE. Use it; copy it; share it with your 
  107. friends. Your financial support is appreciated. If you find the program to be 
  108. a valuable tool, please send $10 to: 
  109.  
  110.                                Thomas A. Lundin
  111.                             Graphics Unlimited Inc.
  112.                            3000 Second Street North
  113.                             Minneapolis, MN  55411
  114.                                 (612) 588-7571
  115.  
  116. Superbreaker was written in a language called UltraFILTR. It will run on any 
  117. MS-DOS computer which has at least 128K of RAM.
  118.  
  119.